STIMP_geom: Anleitung

bin
doc
help
Ultraconv
Assign.Skript
doc.info
Install
Install.info
STIMP_geom.readme

Verzeichnis bin/

pnmarith
pnmcarith
pnmclogic
pnmdoublepack
pnmfit
pnminvert
pnmlogic
pnmmaxval
pnmmirror
pnmrotate
pnmscale

Verzeichnis doc/

gfx
geom.deutsch.html
geom.deutsch.html.info
geom.english.html
geom.english.html.info

Verzeichnis doc/gfx/

d.gif
gb.gif

Verzeichnis help/

pnmarith.syntax
pnmcarith.syntax
pnmclogic.syntax
pnmdoublepack.syntax
pnmfit.syntax
pnminvert.syntax
pnmlogic.syntax
pnmmaxval.syntax
pnmmirror.syntax
pnmrotate.syntax
pnmscale.syntax

Verzeichnis Ultraconv/

Catalogs
ReqDesc
AddNewFilters.Skript
Filters.new

Verzeichnis Ultraconv/Catalogs/

Deutsch

Verzeichnis Ultraconv/Catalogs/Deutsch/

STIMP_geom.catalog

Verzeichnis Ultraconv/ReqDesc/

Borders1
Borders2
ConstFloat
ConstInt

Sollte eine der Dateien fehlen, holen Sie sich besser eine vollständige Version, am besten gleich von meiner Homepage.

SHAREWARE VERSION

Alle in diesem Archiv enthaltenen Dateien unterliegen dem Copyright, d.h. (c) Stefan Diener. Es ist gestattet, dieses Archiv frei weiterzuverteilen, aber es ist verboten, dieses Archiv zu verändern und die modifizierte Form in Umlauf zu bringen. (Insbesondere ist es nicht gestattet, diese Notiz zu entfernen !),

Ausnahmen von diesen Regelungen bedürfen meiner persönlichen Zustimmung !

Dieses Paket enth�lt:

einen unschönen "Shareware-Effekt" auf allen Ziel-Bildern,
unoptimierte 68000er Programmversionen,
keine Quelltexte,
nicht alle Optionen (nicht hier, aber in anderen Paketen).

REGISTRIERTE VERSION

Sollten Sie Teile dieses Paketes regelmäßig benutzen, so ist es Ihre Pflicht, sich registrieren zu lassen. Ihre Vorteile:

kein häßlicher "Shareware-Effekt" auf den Ziel-Bildern,
optimierte Programmversionen für 68000, 68020, 68030+68882 und 68040,
(Eine PowerPC-Version ist ebenfalls möglich, aber dazu muß ich erst eine PowerUP-Karte anschaffen. Und das hängt allein davon ab, wieviele Leute sich registrieren lassen ...)
volle Ultraconv-Unterstützung (sofern sinnvoll),
alle Optionen verfügbar (falls in Shareware-Version eingeschränkt),
C++ Quelltexte (nicht von allen Programmen, aber meist),
detailierte Entwickler-Dokumentation,
freie Updates.

Denken Sie daüber nach und Sie werden sehen, daß es sich lohnt.

Preise:

Erstes STIMP-Paket - Deutschland
bar ODER Euro-Scheck Nachnahme Überweisung

via E-Mail 10 DM - 10 DM

Post 15 DM 23 DM 15 DM

Zweites++ STIMP-Paket - Deutschland
bar ODER Euro-Scheck Nachnahme Überweisung

via E-Mail 6 DM - 6 DM

Post 11 DM 19 DM 11 DM

Nur in Deutschland: Sie haben die Möglichkeit, das Geld direkt auf mein Konto zu überweisen. Schicken Sie mir bitte eine E-Mail oder einen Brief, für welche(s) Paket(e) Sie sich registrieren lassen möchten.

Erstes STIMP-Paket - Deutschland
	bar ODER Euro-Scheck	Nachnahme	Überweisung
via E-Mail	10 DM	-	10 DM
Post	15 DM	23 DM	15 DM

Zweites++ STIMP-Paket - Deutschland
	bar ODER Euro-Scheck	Nachnahme	Überweisung
via E-Mail	6 DM	-	6 DM
Post	11 DM	19 DM	11 DM

Kontonummer: 100 711 53 04
bei: Advance Bank, München
BLZ: 702 300 00
Zweck: "Ihr Name"

Meine Adresse: Stefan Diener, Wilhelmstr. 7, D-73433 Aalen.

Erstes STIMP-Paket - Europa, Welt
bar ODER Euro-Scheck

via E-Mail 10 DM/6 US$

Post 15 DM/9 US$

Luftpost 17 DM/11 US$

Zweites++ STIMP-Paket - Europa, Welt
bar ODER Euro-Scheck

via E-Mail 6 DM/4 US$

Post 11 DM/7 US$

Luftpost 13 DM/8 US$

Meine Adresse: Stefan Diener, Wilhelmstr. 7, D-73433 Aalen.

Erstes STIMP-Paket - Europa, Welt
	bar ODER Euro-Scheck
via E-Mail	10 DM/6 US$
Post	15 DM/9 US$
Luftpost	17 DM/11 US$

Zweites++ STIMP-Paket - Europa, Welt
	bar ODER Euro-Scheck
via E-Mail	6 DM/4 US$
Post	11 DM/7 US$
Luftpost	13 DM/8 US$

Für registrierte Programmversionen gelten andere Copyright-Bedingungen:

Das gesamte Paket ist (c) Stefan Diener.
Es ist nicht gestattet, das Paket oder Teile davon in irgendeiner Form weiterzuverteilen.
Sie können eine Sicherheitskopie des Programms erstellen. Diese darf aber nicht bei einem guten Freund "gelagert" werden.
Sie können Teile der Quelltexte und der Entwickler-Quellen in eigenen Programmen verwenden, solange bei einer Veröffentlichung keinerlei Geld verdient wird. Folgerung: Es ist nicht gestattet, (Teile der) Quelltexte in kommerzieller Software oder Shareware zu verwenden.

Ausnahmen von diesen Regelungen bedürfen meiner persönlichen Zustimmung !

VERSION

Diese Anleitung bezieht sich auf die Version 1.01 des Programmpaketes. Sollten Sie eine neuere Version des gesamten Archivs besitzen, können Sie diese Datei getrost vergessen.

GARANTIE

Es kann keinerlei Garantie gegeben werden. Es gibt weder eine Garantie darauf, daß das Programm auf Ihrem Rechner läuft, noch darauf, daß das Programm den angegebenen Zweck erfüllt. Und es übernimmt auch niemand irgendeine Haftung für Schäden, die an Ihrem Rechner durch sachgemäße oder unsachgemäße Benutzung des Programms entstehen. Es kann nicht dafür garantiert werden, daß die Bildschirmausgaben, die das Programm erzeugt, auch korrekt sind. Auch hier keine Haftung. Sollten Sie dieses Programm benutzen, so tun Sie das auf eigenes Risiko.

ABER: Es wurde mit Nachdruck daran gearbeitet, das Programm möglichst von allen Fehlern zu befreien und es wurde ein erheblicher Aufwand auf das Testen des Programms verwendet. Die Chance, daß das Programm unentdeckte Fehler enthält, besteht jedoch weiterhin.

ANFORDERUNGEN

STIMP_geom benötigt folgende Dinge:

mindestens Kickstart 2.0 (das ist Version 37.175)
mathieeedoubbas.library (Version egal) in LIBS:
mathieeedoubtrans.library (Version egal) in LIBS:

INSTALLATION

Benutzen Sie einfach das Installer-Skript "Install", um das Programmpaket automatisch installieren zu lassen.
Selbstverständlich können Sie die Installation auch per Hand vornehmen. Sie tun dies aber auf eigenes Risiko ! Ich habe leider keine Zeit, alle Installationsschritte einzeln zu erkl�ren, da die Installation dazu zu umfangreich geworden ist, leider.

PROGRAMMSTART

Haben Sie die Installation erfolgreich durchgeführt, starten Sie ein Programm Ihrer Wahl OHNE die Angabe von Parametern, z.B. "pgmmedian". Jetzt sollte ein Hilfstext erscheinen. Bekommen Sie stattdessen die Meldung "helpfile not found", ist bei der Installation etwas schief gelaufen. (Haben Sie ev. vergessen, einen Reset durchzuführen ?)

Hinweis: Die Option "-?" wird nicht mehr unterstützt.

Die Hilfstexte sollten nun zur Benutzung der Programme eigentlich ausreichen. Die Bedeutung der jeweiligen Optionen ist dann in der Dokumentation der einzelnen Programme nachzulesen (nicht in der SHAREWARE-Version).

Noch kurz zu den verwendeten Symbolen in der Syntax-Zeile:

Eckige Klammern bedeuten, daß dieser Parameter optional ist, d.h. auch weggelassen werden kann.

Senkrechte Striche bedeuten ein exklusives ODER, d.h. von allen Parametern, die hintereinander durch senkrechte Striche verbunden sind, kann nur einer gewählt werden.

"default" bedeutet voreingestellter Wert, d.h. wenn Sie diesen optionalen Parameter weglassen, wird automatisch der voreingestellte Wert angenommen.

Zahlenwerte sind unmittelbar hinter dem einleitenden Buchstaben des Parameters anzugeben, z.B. richtig: "-f32", falsch: "-f 32".

Jeder Parameter muß sein eigenes "-" oder "+" besitzen. Das Zusammenfassen von Parametern ist nicht möglich.

Folgerung: Es können keine Dateinamen verwendet werden, die mit einem "-" oder "+" beginnen. Auch die Verwendung von Anführungszeichen oder Hochkommas bringt nichts. Diese Einschränkung sollte aber im allgemeinen nicht allzu gravierend sein. Tip: Verwenden Sie ein Utility, das die Verzeichnisse "." und ".." nutzbar macht (z.B. UnixDirs) und setzen Sie "./" vor den Dateinamen, der mit "-" oder "+" beginnt. Dann geht´s.

Werfen Sie auch einen Blick auf den folgenden Abschnitt "Umleitungen" !

UMLEITUNGEN

Ein neues Feature ist die Möglichkeit der Eingabe- und Ausgabeumleitung. Zu beachten ist nur, daß der (nun nicht mehr benötigte) Dateiname durch einen "-" zu ersetzen ist. Einige Beispiele:

normalerweise:
"pgmmedian lena.pgm result.pgm"
(wobei lena.pgm Eingabedatei und result.pgm Ausgabedatei ist)
Ausgabe-Umleitung:
"pgmmedian lena.pgm - >result.pgm"
Eingabe-Umleitung:
"pgmmedian - result.pgm <lena.pgm"
Eingabe- und Ausgabe-Umleitung:
"pgmmedian - - <lena.pgm >result.pgm"
Benutzung von Pipes (Grüße von UNIX):
"pgmmedian lena.pgm - | pnmmargin -a0 -m5 - result.pgm"
oder noch komplizierter mit 2 Pipes:
"pnmaddnoise -w0.8 -p20.0 lena.pgm - | pgmmedian - - | pnmview -"
(Beachte: Um die Eingabe-Umleitung des Programms pnmview benutzen zu können, benötigen Sie eine neuere Version als 0.01ß ...)

Dieses Feature wurde hauptsächlich für die Benutzung von Ultraconv zur Verfügung gestellt, ist aber bei der Programmbenutzung in UNIX ebenfalls sehr nützlich.

Beachte: Man benötigt zusätzliche Software für Pipes beim AmigaOS.

ULTRACONV 3

Drei Programme wurden in Ultraconv3 integriert: pnmfit, pnmcarith, pnmclogic. Es werden weitere folgen (pnmarith, pnmlogic, pnmdoublepack), aber erst für registrierte Benutzer.

EINSCHRÄNKUNGEN

Die Dateien mit den Kennungen P1, P2 und P3 werden nicht unterstützt. Es handelt sich dabei um die Text-Versionen von PBM, PGM und PPM. Aber keine Angst: die binären Versionen von PBM, PGM und PPM (Kennungen P4, P5 und P6) werden unterstützt und sind ohnehin die gängigeren Dateiformate. Die Text-Versionen verschlingen unnötig viel Speicherplatz, d.h. die Dateien sind größer und das Laden/Speichern dauert entsprechend länger. Da alle Programme des NetPBM-Paketes sowieso die binären Versionen erzeugen, wird man in der Praxis wohl nur selten etwas mit den Text-Versionen zu tun haben. Ich habe mich deshalb entschlossen, mir den Aufwand zum Implementieren der Text-Versionen zu sparen. Wer trotzdem darauf Wert legt, kann ja die Quelltexte des NetPBM-Paketes studieren ...

QUELLTEXT

Der Quelltext zu diesem Paket ist noch nicht verfügbar. Registrierte Benutzer werden die Quelltexte (bzw. Teile davon) bei der Registrierung erhalten.

WAS IST STIMP ?

Wenn Sie den Abschnitt "Registrierte Version" gelesen haben, werden Sie sich sicher fragen, warum gerade die Abkürzung STIMP verwendet wurde. Nun, STIMP steht für "STefan´s IMage Processing". Ich gebe zu, kein wirklich origineller Name. Aber irgendein Name mußte eben her.

ENTWICKLUNGSUMGEBUNG

Compiler:

MaxonC++ 4.0 Light (05.11.96), Maxon Computer GmbH

Computer:

AUTOR

Name : Stefan Diener
E-Mail : stefan.diener@freepage.de
WWW : http://private.freepage.de/stefan.diener/index.html
Adresse : Wilhelmstr. 7, D-73433 Aalen, Deutschland